.TH CARTCONV 1 "March 2017" "VICE"
.SH NAME
cartconv \- a stand alone cartridge conversion program
.SH SYNOPSIS
.IR cartconv
[options]
.SH DESCRIPTION
.IR cartconv
is a cartridge conversion utility, it can convert between binary and .crt
images and it can 'insert' binary and/or .crt images into the EPROM type of
cartridges. It is part of the
.IR VICE
emulator.
.TP 8
.B \-i \fIinput name\fR
This parameter is mandatory, it should contain the name of the binary/.crt
file you want to convert. For the EPROM type of cartridges this parameter
can be used multiple times to insert images into the resulting file.
.TP
.B \-o \fIoutput name\fR
This parameter is mandatory, it should contain the name of the binary/.crt
file you want to convert the input file to.
.TP
.B \-t \fIcarttype\fR
This parameter is optional. It is only needed when converting to a .crt
file. See below for the supported cartridge types.
.TP
.B \-n \fIcart name\fR
This parameter is optional and is used as the cartridge name when creating
a .crt file.
.TP
.B \-l \fIloadaddress\fR
This parameter is optional and is used as the load-address when converting
a .crt file to a .prg file, or when converting to a generic type .crt file.
.TP
.B \-f \fIinput name\fR
This parameter is optional, and is meant to output information about the
named file. It can't be used in conjuction with any of the other parameters.
.TP
.B \-r
This parameter is optional, it enables repair mode (accept broken input files)
.TP
.B \-q
This parameter is optional, it disables all non-error messages
.P

The following cartridge types are supported:

.TP
.B bin
Binary .bin file (Default crt->bin)
.TP
.B normal
Generic 8kB/12kB/16kB .crt file (Default bin->crt)
.TP
.B prg
Binary C64 .prg file with load-address
.TP
.B ulti
Ultimax mode 4kB/8kB/16kB .crt file
.TP
.B ap
Atomic Power .crt file
.TP
.B ar2
Action Replay MK2 .crt file
.TP
.B ar3
Action Replay MK3 .crt file
.TP
.B ar4
Action Replay MK4 .crt file
.TP
.B ar5
Action Replay V5 .crt file
.TP
.B cap
Capture .crt file
.TP
.B comal
Comal 80 .crt file
.TP
.B dep256
Dela EP256 .crt file, extra files can be inserted
.TP
.B dep64
Dela EP64 .crt file, extra files can be inserted
.TP
.B dep7x8
Dela EP7x8 .crt file, extra files can be inserted
.TP
.B din
Dinamic .crt file
.TP
.B dsm
Diashow-Maker .crt file
.TP
.B easy
EasyFlash .crt file
.TP
.B ecr
Easy Calc Result .crt file
.TP
.B epyx
Epyx FastLoad .crt file
.TP
.B exos
EXOS .crt file
.TP
.B expert
Expert Cartridge .crt file
.TP
.B f64
Formel 64 .crt file
.TP
.B fc1
The Final Cartridge .crt file
.TP
.B fc3
The Final Cartridge III .crt file
.TP
.B fcp
Final Cartridge Plus .crt file
.TP
.B ff
Freeze Frame .crt file
.TP
.B fm
Freeze Machine .crt file
.TP
.B fp
Fun Play .crt file
.TP
.B gk
Game Killer .crt file
.TP
.B gmod2
GMod2 .crt file
.TP
.B gs
C64 Games System .crt file
.TP
.B ide64
IDE64 .crt file
.TP
.B ieee
IEEE-488 Interface .crt file
.TP
.B kcs
KCS Power Cartridge .crt file
.TP
.B ks
Kingsoft .crt file
.TP
.B mach5
MACH 5 .crt file
.TP
.B md
Magic Desk .crt file
.TP
.B mf
Magic Formel .crt file
.TP
.B mikro
Mikro Assembler .crt file
.TP
.B mmc64
MMC64 .crt file
.TP
.B mmcr
MMC Replay .crt file
.TP
.B mv
Magic Voice .crt file
.TP
.B ocean
Ocean .crt file
.TP
.B p64
Prophet64 .crt file
.TP
.B pf
Pagefox .crt file
.TP
.B rep256
REX 256k EPROM Cart .crt file, extra files can be inserted
.TP
.B rgcd
RGCD .crt file
.TP
.B ross
ROSS .crt file
.TP
.B rr
Retro Replay .crt file
.TP
.B rrnet
RR-Net MK3 .crt file
.TP
.B ru
REX Utility .crt file
.TP
.B s64
Snapshot 64 .crt file
.TP
.B sb
Structured BASIC .crt file
.TP
.B se5
Super Explode V5.0 .crt file
.TP
.B sg
Super Games .crt file
.TP
.B silver
Silverrock 128K Cartridge .crt file
.TP
.B simon
Simons' BASIC .crt file
.TP
.B ss4
Super Snapshot V4 .crt file
.TP
.B ss5
Super Snapshot V5 .crt file
.TP
.B star
Stardos .crt file
.TP
.B wl
Westermann Learning .crt file
.TP
.B ws
Warp Speed .crt file
.TP
.B zaxxon
Zaxxon .crt file
@end table

.SH SEE ALSO
.BR vice(1),
.BR c1541(1),
.BR petcat(1)
.P
@HTMLDOC@
.SH AUTHORS
Marco van den Heuvel <blackystardust68@yahoo.com>
